wepage: a werc-like site generator
========================================

I used to use `werc <http://werc.cat-v.org/>`__ to make my home
page. However, werc uses CGI, which is not supported by most of the
modern web servers. After I knew how CGI works, I wrote a script
called werc-gen, which simulates the CGI calls to generate the static
pages. However, it still requires rc shell, which is not installed on
a common GNU/Linux system, and usually fails to work. That's why I
plan to write a new static site generator.

Recently, I saw an article from Hacker News called `m4: the one true
templating language <https://chrisman.github.io/9.html>`__, which I
think is a good start to make my site generator. So I copy the werc
HTML templates and rewrite them in m4, and make this project called
wepage.

The wepage site generator contains two tools:

- navgen.py: generates the werc-like navigation side bar, currently
  written in Python
- sitegen.sh: generates a site from markdown and reStructuredText
  files

To use this tool, run::

  ./sitegen.sh <source dir> <dest dir>

Then you get your site.

Related work
----------------

I saw another two small static site generators recently, and they look more simple:

- `shayla <https://git.sr.ht/~ne02ptzero/shayla>`__: a very fast site generator written in C
- ssg: the site generator which inspires shayla, using Unix shell, find, grep, awk

License
--------

wepage is in the public domain.
